package com.zenithmind.note.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.zenithmind.note.pojo.dto.NoteDTO;
import com.zenithmind.note.pojo.query.NoteQuery;
import com.zenithmind.note.pojo.entity.Note;
import com.zenithmind.note.pojo.vo.NoteVO;
import com.zenithmind.common.result.PageResult;
import com.zenithmind.note.pojo.vo.NoteTagVO;

import java.util.List;
import java.util.Map;

/**
 * 笔记服务接口
 */
public interface NoteService extends IService<Note> {
    /**
     * 创建笔记
     * 
     * @param noteDTO 笔记数据
     * @return 笔记ID
     */
    Note createNote(NoteDTO noteDTO);
    
    /**
     * 更新笔记
     * 
     * @param noteDTO 笔记数据
     */
    void updateNote(NoteDTO noteDTO);
    
    /**
     * 删除笔记
     * 
     * @param id 笔记ID
     */
    void deleteNote(String id);
    
    /**
     * 获取笔记详情 - 内部获取当前用户ID
     * 
     * @param id 笔记ID
     * @return 笔记详情
     */
    NoteVO getNoteDetail(String id);
    
    /**
     * 获取笔记详情 - 外部传入用户ID
     * 
     * @param id 笔记ID
     * @param userId 用户ID，用于判断是否已点赞
     * @return 笔记详情
     */
    NoteVO getNoteDetail(String id, String userId);
    
    /**
     * 分页查询笔记列表
     * 
     * @param query 查询条件
     * @return 分页结果
     */
    PageResult<NoteVO> notePage(NoteQuery query);
    
    /**
     * 点赞/取消点赞 - 内部获取当前用户ID
     * 
     * @param noteId 笔记ID
     */
    void toggleLike(String noteId);
    
    /**
     * 点赞/取消点赞 - 外部传入用户ID
     * 
     * @param noteId 笔记ID
     * @param userId 用户ID
     */
    void toggleLike(String noteId, String userId);
    
    /**
     * 更新笔记状态
     * 
     * @param id 笔记ID
     * @param status 状态
     */
    void updateStatus(String id, Integer status);
    
    /**
     * 批量删除笔记
     * 
     * @param ids 笔记ID列表
     */
    void deleteBatch(List<String> ids);
    
    /**
     * 批量更新笔记状态
     * 
     * @param ids 笔记ID列表
     * @param status 状态
     */
    void batchUpdateStatus(List<String> ids, Integer status);
    
    /**
     * 更新浏览次数
     * 
     * @param id 笔记ID
     */
    void updateViewCount(String id);
    
    /**
     * 更新点赞数
     * 
     * @param id 笔记ID
     * @param delta 增量
     */
    void updateLikeCount(String id, int delta);
    
    /**
     * 管理员添加或修改笔记
     * 
     * @param note 笔记信息
     * @return 笔记VO
     */
    NoteVO addOrUpdateNoteByAdmin(Note note);

    /**
     * 获取标签列表及使用统计
     * @return 标签列表
     */
    List<Map<String, Object>> getTagsWithCount();
    
    /**
     * 获取笔记的标签列表
     * 
     * @param noteId 笔记ID
     * @return 标签列表
     */
    List<NoteTagVO> getNoteTagList(String noteId);
    
    /**
     * 设置笔记标签
     * 
     * @param noteId 笔记ID
     * @param tagIds 标签ID列表
     */
    void setNoteTags(String noteId, List<String> tagIds);
    
    /**
     * 根据标签ID查询笔记列表
     * 
     * @param tagId 标签ID
     * @param query 查询条件
     * @return 分页结果
     */
    PageResult<NoteVO> getNotesByTagId(String tagId, NoteQuery query);
} 